home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Performance Co-Pilot 1.3
/
SGI Performance Co-Pilot 1.3.iso
/
dist
/
pcp.idb
/
usr
/
share
/
catman
/
u_man
/
cat1
/
pmclient.z
/
pmclient
Wrap
Text File
|
1997-04-03
|
6KB
|
133 lines
PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111)))) PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111))))
NNNNAAAAMMMMEEEE
ppppmmmmcccclllliiiieeeennnntttt - a simple performance metrics client
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
ppppmmmmcccclllliiiieeeennnntttt [----ppppzzzz] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _n_a_m_e_s_p_a_c_e] [----ssss _s_a_m_p_l_e_s] [----SSSS
_n_u_m_s_e_c] [----tttt _d_e_l_t_a] [----ZZZZ _t_i_m_e_z_o_n_e]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
ppppmmmmcccclllliiiieeeennnntttt is a simple client that uses the Performance Metrics Application
Programming Interface (PMAPI) to report some high-level system
performance metrics.
The real value of ppppmmmmcccclllliiiieeeennnntttt is as a sample client using the PMAPI, and to
this end the source code is included in the _p_c_p._c_l_i_e_n_t._d_e_m_o subsystem of
the Performance Co-Pilot (PCP) product.
By default, metrics are fetched from the local host, however if the ----hhhh
option is specified, then ppppmmmmcccclllliiiieeeennnntttt connects to ppppmmmmccccdddd(1) on _h_o_s_t and
fetches metrics from there.
Alternatively, if the ----aaaa option is used, the metrics are retrieved from
the PCP archive log files identified by the base name _a_r_c_h_i_v_e.
Using an archive implies a host name, and nominating a host precludes
using an archive, so the options ----aaaa and ----hhhh are mutually exclusive.
Normally ppppmmmmcccclllliiiieeeennnntttt operates on the default Performance Metrics Namespace
(PMNS), however if the ----nnnn option is specified an alternative namespace is
loaded from the file _n_a_m_e_s_p_a_c_e.
Use the ----tttt option to change the reporting interval to once every _d_e_l_t_a
seconds - the default is one every 5.0 seconds.
If the ----ssss option is specified, _s_a_m_p_l_e_s defines the number of samples to
be retrieved and reported. If _s_a_m_p_l_e_s is 0 or ----ssss is not specified,
ppppmmmmcccclllliiiieeeennnntttt will sample and report continuously - this is the default
behaviour.
The output from ppppmmmmcccclllliiiieeeennnntttt is directed to standard output, and lists
+ Aggregate CPU utilization, in the range 0 to 1.
+ If the system has more than 1 CPU, the ordinal number of the busiest
CPU, in the range 0 to ...
+ If the system has more than 1 CPU, the CPU utilization for the busiest
CPU.
+ Real free memory in Mbytes.
PPPPaaaaggggeeee 1111
PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111)))) PPPPMMMMCCCCLLLLIIIIEEEENNNNTTTT((((1111))))
+ Aggregate physical disk I/O operations per second (IOPS).
+ Load average over the last 1 minute and over the last 15 minutes.
By default, ppppmmmmcccclllliiiieeeennnntttt reports the time of day according to the local
timezone on the system where ppppmmmmcccclllliiiieeeennnntttt is run. The ----ZZZZ option changes the
timezone to _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as
described in eeeennnnvvvviiiirrrroooonnnn(5). The ----zzzz option changes the timezone to the local
timezone at the host that is the source of the performance metrics, as
identifed via either the ----hhhh or ----aaaa options.
The ----SSSS option may be used in conjunction with an archive to request that
display start at the time _n_u_m_s_e_c seconds from the start of the archive.
Also when using archives, the ----pppp option requests that the prevailing
real-time delay be applied between samples (see ----tttt) to effect a pause,
rather than the default behaviour of replaying at full speed.
FFFFIIIILLLLEEEESSSS
////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////* default PMNS specification files
////vvvvaaaarrrr////ppppccccpppp////ddddeeeemmmmoooossss////ppppmmmmcccclllliiiieeeennnntttt source code and Makefiles
////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....ppppmmmmcccclllliiiieeeennnntttt
ppppmmmmllllooooggggggggeeeerrrr(1) configuration for creating
an archive suitable for replay with
ppppmmmmcccclllliiiieeeennnntttt
SSSSEEEEEEEE AAAALLLLSSSSOOOO
ppppmmmmggggeeeennnnmmmmaaaapppp(1), ppppmmmmaaaappppiiii(3), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmccccdddd(1), and ppppmmmmkkkkssssttttaaaatttt(1).
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
All are generated on standard error, and are intended to be self-
explanatory.
PPPPaaaaggggeeee 2222